home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / amystp16.lha / AmySTP.doc next >
Text File  |  1995-11-19  |  9KB  |  325 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                        AmySTP.guide v1.6a (19.11.95)
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.        Copyright (©) 1995, The Xperts Group Inc. All Rights Reserved.
  28.                          Author: Manolis S Pappas
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                  - Page 1 -
  68.  
  69.  
  70.  
  71. 1.       AmySTP Manual: Main Menu
  72.  
  73.                                 AmySTP
  74.  
  75.  
  76.                       A Binary To Text Converter
  77.  
  78.  
  79.                              Version 1.6a
  80.  
  81.  
  82.      Copyright (©) 1995, The Xperts Group Inc. All Rights Reserved.
  83.  
  84.  
  85.                         Author: Manolis S Pappas
  86.  
  87. -------------------------------------------------------------------------
  88.  
  89.     Introduction            What is all about...
  90.     Requirements            What do you need...
  91.     Installation            Well, it's pretty straightforward...
  92.     Technostuff!            For the technical minds...
  93.       Examples              For the idiot-proof...
  94.       Contacts              Get in contact...
  95.       Credits!              :-)
  96.  
  97. -------------------------------------------------------------------------
  98.  
  99.   This program is provided "AS IS". No responsibility is taken for ANY
  100. misuse or damage caused by the use of this software. Altough EVERY possible
  101. attempt was made to provide an error-free (bug-free :-) ) software package,
  102. we cannot be responsible for any inconvinience this program may cause to
  103. you! USE AT YOUR OWN RISK!
  104.  
  105. 2.       AmySTP Manual: Introduction
  106.  
  107.     Over the last few years, information is transferred via electronic
  108. computer networks. Data such as texts, lists and even files ARE posted
  109. between users all over the world! Expensive and accurate systems provide the
  110. average user such services.
  111.  
  112.     However, sometimes you want to send a file to someone else, but that
  113. person is not able to receive files by others, just only plain text files.
  114. If the file is plain ASCII, there is no problem, but what if the requested
  115. file is binary?
  116.  
  117.     A few utilities exist for that particular purpose; to allow the encoding
  118. of binary files by using plain ASCII files. The most known one is the UU
  119. Encode format, published by a user, some years ago. It is very popular,
  120. although it has some limitations and dissadvantages. The most noticeable
  121. dissadvantage is that such utilities, create output ASCII files MUCH bigger
  122. that the original binary files. This limits the file-exchanges very much.
  123.  
  124.     Here's AmySTP comes in! It's an alternative binary to ASCII encoder
  125. which, by using special compression algorithms, can create output ASCII
  126. files with similar sizes to the original binary ones. Thus the user is able
  127. to send bigger files via e-mail messages.
  128.  
  129. 3.       AmySTP Manual: Requirements
  130.  
  131.     To use AmySTP you need:
  132.  
  133.     - An AMIGA® computer (well...can't do without one :-) )
  134.     - KickStart 1.2 or later
  135.     - 256K RAM
  136.  
  137.  
  138.                                  - Page 2 -
  139. 3. AmySTP Manual: Requirements
  140.  
  141.     Using AmySTP on bigger files may require more memory, but in any case,
  142. memory usage is very little!
  143.  
  144. 4.       AmySTP Manual: Installation
  145.  
  146.     Installation of AmySTP is very simple. The package consists of two
  147. executable files; AmyStpEncoder and AmyStpDecoder. You just have to copy
  148. those files in your executable path (such as the C: directory).
  149.  
  150.     To use the program, you need to access the Shell. Open a Shell window
  151. and type:
  152.  
  153.     AmyStpEncoder <parameters>
  154.             to encode a file
  155.  
  156.     AmyStpDecoder <parameters>
  157.             to decode a file
  158.  
  159.  
  160.   See also  Usage
  161.  
  162. 5.       AmySTP Manual: AmySTP Usage
  163.  
  164.     Please select:
  165.  
  166.     AmyStpEncoder       AmyStpEncoder Usage...
  167.     AmyStpDecoder       AmyStpDecoder Usage...
  168.  
  169. 6.       AmySTP Manual: AmyStpEncoder Usage
  170.  
  171.     Usage of AmyStpEncoder is:
  172.  
  173.     AmyStpEncoder  [binary_infile] [txt_outfile] {-d=xx} {-l=xx}
  174.  
  175.  Explanation:
  176.  
  177.  binary_infile is the name of the binary file to be encoded
  178.  
  179.  txt_outfile is the name of the output ASCII file to be produced
  180.              from the binary one
  181.  
  182.  Two more optional parameters exist:
  183.  
  184.  -d  Specifies the length of each line in the output file produced. The
  185.      smaller it gets, the bigger the output file gets. Default is 70.
  186.  
  187.  -l  Compression efficiency. Specify the size (in bytes) that the
  188.      output file should be. By specifying a size equal of the size of
  189.      the binary file, AmyStpEncoder compresses the file most (it also
  190.      takes more time that way). Specifying a file size less than the
  191.      original binary file's, MAY produce a smaller file, but not
  192.      always. USE WITH CAUTION!
  193.  
  194.   NOTE: Option -l creates files which are INCOMPATIBLE with the PC version
  195.         of STP.
  196.  
  197. 7.       AmySTP Manual: AmyStpDecoder Usage
  198.  
  199.     Usage of AmyStpDecoder is:
  200.  
  201.     AmyStpDecoder  [txt_infile]
  202.  
  203.  Explanation:
  204.  
  205.  txt_infile is the name of the ASCII file to produced that will
  206.             produce the binary one
  207.  
  208.  
  209.                                  - Page 3 -
  210. 7. AmySTP Manual: Technical Information
  211.  
  212.  
  213. 8.       AmySTP Manual: Technical Information
  214.  
  215.     AmySTP uses a similar algorithm like the UU Encode utilities do.
  216. However, to produce smaller output ASCII files, AmySTP utilizes ASCII
  217. character codes in the range 32-255 (where UU Encode uses characters
  218. 32-127). This can cause some problems with system that do not use/provide
  219. characters 128-255.
  220.  
  221.     This makes AmySTP useless if you want to transfer files via Internet
  222. mail (altough there exist servers that do not have problems with this
  223. characters - check to find out if you have one).
  224.  
  225.     Even if this limitation sounds terrific, AmySTP is useful. You can use
  226. it to post files via FidoNet-compatible systems. These systems were designed
  227. later than the Usenet/Internet ones, thus they permit the user to write with
  228. characters beyond 127. Using AmySTP in such networks can lower the required
  229. bandwidth extremely, so the telephone costs.
  230.  
  231.     Care must be taken with FidoNet networks, also: be sure that neither
  232. your mail software (Off-Line Reader, Tosser) or your BBS does not crop ASCII
  233. characters beyond character 128 (a few badly programmed PC BBS/Editors, such
  234. as GEdit have problems). All Amiga BBS software is know to be working
  235. perfectly!
  236.  
  237.     Following these simple rules, AmySTP will serve you well for a long
  238. time, without problems!
  239.  
  240. 9.       AmySTP Manual: Examples
  241.  
  242.     Some examples of AmySTP usage:
  243.  
  244.    - To encode a binary file file.ext to an ASCII one file.txt, type:
  245.  
  246.        AmyStpEncoder file.ext file.txt
  247.  
  248.    - To encode a binary file file1.ext to an ASCII one file1.txt with
  249.      a line length of 65 characters, type:
  250.  
  251.        AmyStpEncoder file1.ext file1.txt -d=65
  252.  
  253.    - To encode a binary file file2.ext to an ASCII one file2.txt with
  254.      a line length of 65 characters and with a suggested output file
  255.      length of 5000 bytes (original file2.ext size=4000bytes), type:
  256.  
  257.        AmyStpEncoder file2.ext file2.txt -d=65 -l=5000
  258.  
  259.    - To decode an ASCII STP file file.txt, type:
  260.  
  261.        AmyStpDecoder file.txt
  262.  
  263. 10.      AmySTP Manual: Contacts
  264.  
  265.     Feel free to contact me for any ideas, questions, bug reports or just
  266. about anything else. My address is:
  267.  
  268.                             Manolis S Pappas
  269.                             Thermopilon 24
  270.                             14231 Nea Ionia
  271.                             Athens
  272.                             GREECE
  273.  
  274.     I can also be reached via electronic networks:
  275.  
  276.     E-Mail:     mpap@acrogate.ath.forthnet.gr
  277.                 mpappas@posidon.servicenet.ariadne-t.gr
  278.  
  279.  
  280.                                  - Page 4 -
  281. 10.        AmySTP Manual: Contacts
  282.  
  283.     AmigaNET:   39:250/3.19
  284.     FidoNET:    2:410/128.19
  285.  
  286.  
  287.     See you soon.
  288.     :-)
  289.  
  290. 11.      AmySTP Manual: Credits       :-)
  291.  
  292.     AmySTP utilities were programmed by Manolis S Pappas in 1994-95.
  293.     Compiled using the excellent SAS/C++ v6.56 system.
  294.  
  295.     The original PC version (with no compression efficiency option)
  296.     was programmed by Costas Lialiambis using Borland C++.
  297.  
  298.     Hello goes out to:
  299.  
  300.     The rest of the Xperts Group:
  301.  
  302.                                 Argiris D Maistralis
  303.                                 Menelaos P Mikedis
  304.                                 Andreas C Apessos
  305.                                 Costas E Tabouris
  306.                                 Dimitris Andiopoulos
  307.  
  308.      The people behind the Amiga community in Greece.
  309.      The people behind the Amiga supporters in Greece, via BBS's,
  310.      and especially to:
  311.  
  312.                                 Manos Konstantiniadis (Odyssey BBS)
  313.                                 Padelis Andreadis    (Logic Systems BBS)
  314.                                 George Hionides       (HardCore BBS)
  315.  
  316.      The "Club of Amiga Friends" club.
  317.  
  318.      Thank you for trying AmySTP.
  319.  
  320.  Thanks to the Amiga      //   for being the BEST personal computer
  321.                          //    human ever made!
  322.                     \  //
  323.                      \//
  324.                       \/
  325.